Microsoft DirectX 8.1 (C++)

IRenderEngine::GetGroupOutputPin

The GetGroupOutputPin method retrieves the output pin for the specified group.

Syntax

HRESULT GetGroupOutputPin(
    long Group,
    IPin **ppRenderPin
);

Parameters

Group

Zero-based index that specifies the group.

ppRenderPin

[out] Address of a pointer to receive the output pin's IPin interface.

Return Value

Returns an HRESULT value. Possible values include the following:

Value Description
S_FALSE Group does not have an output pin.
S_OK Success.
E_INVALIDARG Invalid argument.
E_MUST_INIT_RENDERER Render engine failed to initialize.
E_POINTER Invalid pointer.
E_RENDER_ENGINE_IS_BROKEN Operation failed because project was not rendered successfully.
E_UNEXPECTED Unexpected error.

Remarks

Before calling this method, call IRenderEngine::ConnectFrontEnd to build the front end of the graph. Each group represents a single media stream, and the front end has a corresponding output pin.

You can use this method to create the rendering portion of a file-writing graph. Connect the output pins to multiplexer filters and file writer filters. For more information, see Rendering a Project.

For preview, you don't need to call this method. Just call ConnectFrontEnd followed by IRenderEngine::RenderOutputPins.

If the method returns S_OK, the IPin interface that it returns has an outstanding reference count. Be sure to release the interface when you are finished using it.

See Also